home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / convrtrs / pbmplus / manuals.lha / manuals / ppm / ppmtoxpm.man < prev    next >
Encoding:
Text File  |  1993-12-09  |  3.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      ppmtoxpm(1)          AMIGA (Tue Apr 9 1991)           ppmtoxpm(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           ppmtoxpm - convert a portable pixmap into an X11 pixmap
  10.  
  11.      SYNOPSIS
  12.           ppmtoxpm [-name <xpmname>] [-rgb <rgb-textfile>] [-xpm1]
  13.           [<ppmfile>]
  14.  
  15.      DESCRIPTION
  16.           Reads a portable pixmap as input.  Produces X11 pixmap
  17.           (version 3) as output which can be loaded directly by the
  18.           XPM library.
  19.  
  20.           The -name option allows one to specify the prefix string
  21.           which is printed in the resulting XPM output.  If not
  22.           specified, will default to the filename (without extension)
  23.           of the <ppmfile> argument.  If -name is not specified and
  24.           <ppmfile> is not specified (i.e. piped input), the prefix
  25.           string will default to the string "noname".
  26.  
  27.           The -rgb option allows one to specify an X11 rgb text file
  28.           for the lookup of color name mnemonics.  This rgb text file
  29.           is typically the /usr/lib/X11/rgb.txt of the MIT X11
  30.           distribution, but any file using the same format may be
  31.           used.  When specified and a RGB value from the ppm input
  32.           matches a RGB value from the <rgb-textfile>, then the
  33.           corresponding color name mnemonic is printed in the XPM's
  34.           colormap.  If -rgb is not specified, or if the RGB values
  35.           don't match, then the color will be printed with the #RGB,
  36.           #RRGGBB, #RRRGGGBBB, or #RRRRGGGGBBBB hexadecimal format.
  37.  
  38.           The -xpm1 option allows one to create an X11 version 1
  39.           pixmap.
  40.  
  41.           All flags can be abbreviated to their shortest unique
  42.           prefix.
  43.  
  44.           For example, to convert the file "dot" (found in
  45.           /usr/include/X11/bitmaps), from xbm to xpm one could specify
  46.  
  47.                xbmtopbm dot | ppmtoxpm -name dot
  48.  
  49.           or, with a rgb text file (in the local directory)
  50.  
  51.                xbmtopbm dot | ppmtoxpm -name dot -rgb rgb.txt
  52.  
  53.      BUGS
  54.           An option to match the closest (rather than exact) color
  55.           name mnemonic from the rgb text would be a desirable
  56.           enhancement.
  57.  
  58.           Truncation of the least significant bits of a RGB value may
  59.           result in nonexact matches when performing color name
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 12/9/93)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ppmtoxpm(1)          AMIGA (Tue Apr 9 1991)           ppmtoxpm(1)
  71.  
  72.  
  73.  
  74.           mnemonic lookups.
  75.  
  76.      SEE ALSO
  77.           ppm(5)
  78.           XPM Manual by Arnaud Le Hors lehors@mirsa.inria.fr
  79.  
  80.      AUTHOR
  81.           Copyright (C) 1990 by Mark W. Snitily.
  82.  
  83.           Permission to use, copy, modify, and distribute this
  84.           software and its documentation for any purpose and without
  85.           fee is hereby granted, provided that the above copyright
  86.           notice appear in all copies and that both that copyright
  87.           notice and this permission notice appear in supporting
  88.           documentation.  This software is provided "as is" without
  89.           express or implied warranty.
  90.  
  91.           This tool was developed for Schlumberger Technologies, ATE
  92.           Division, and with their permission is being made available
  93.           to the public with the above copyright notice and permission
  94.           notice.
  95.  
  96.           Upgraded to XPM2 by
  97.              Paul Breslaw, Mecasoft SA, Zurich, Switzerland
  98.           (paul@mecazh.uu.ch)
  99.              Thu Nov  8 16:01:17 1990
  100.  
  101.           Upgraded to XPM version 3 by
  102.              Arnaud Le Hors (lehors@mirsa.inria.fr)
  103.              Tue Apr 9 1991
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 12/9/93)
  130.  
  131.  
  132.  
  133.